home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glcopyteximage1dext.z / glcopyteximage1dext
Encoding:
Text File  |  2001-04-17  |  14.2 KB  |  201 lines
  1.  
  2.  
  3.  
  4. ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT - copy pixels into a 1D texture image
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT( GLenum _t_a_r_g_e_t,
  14.                                GLint _l_e_v_e_l,
  15.                                GLenum _i_n_t_e_r_n_a_l_f_o_r_m_a_t,
  16.                                GLint _x,
  17.                                GLint _y,
  18.                                GLsizei _w_i_d_t_h,
  19.                                GLint _b_o_r_d_e_r )
  20.  
  21.  
  22. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  23.      _t_a_r_g_e_t          The target texture.  Must be GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD
  24.  
  25.      _l_e_v_e_l           The level-of-detail number.  Level 0 is the base image
  26.                      level.  Level _n is the _nth mipmap reduction image.
  27.  
  28.      _i_n_t_e_r_n_a_l_f_o_r_m_a_t  The internal storage format of the texture image.  Must
  29.                      be one of the following symbolic constants:  GGGGLLLL____AAAALLLLPPPPHHHHAAAA,
  30.                      GGGGLLLL____AAAALLLLPPPPHHHHAAAA4444____EEEEXXXXTTTT, GGGGLLLL____AAAALLLLPPPPHHHHAAAA8888____EEEEXXXXTTTT, GGGGLLLL____AAAALLLLPPPPHHHHAAAA11112222____EEEEXXXXTTTT,
  31.                      GGGGLLLL____AAAALLLLPPPPHHHHAAAA11116666____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____EEEEXXXXTTTT,
  32.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____EEEEXXXXTTTT,
  33.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA,
  34.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____AAAALLLLPPPPHHHHAAAA4444____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE6666____AAAALLLLPPPPHHHHAAAA2222____EEEEXXXXTTTT,
  35.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____AAAALLLLPPPPHHHHAAAA8888____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA4444____EEEEXXXXTTTT,
  36.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA11112222____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____AAAALLLLPPPPHHHHAAAA11116666____EEEEXXXXTTTT,
  37.                      GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY____EEEEXXXXTTTT, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY4444____EEEEXXXXTTTT, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY8888____EEEEXXXXTTTT,
  38.                      GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11112222____EEEEXXXXTTTT, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11116666____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB,
  39.                      GGGGLLLL____RRRRGGGGBBBB2222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB4444____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB5555____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB8888____EEEEXXXXTTTT,
  40.                      GGGGLLLL____RRRRGGGGBBBB11110000____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB11112222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB11116666____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBBAAAA,
  41.                      GGGGLLLL____RRRRGGGGBBBBAAAA2222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBBAAAA4444____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB5555____AAAA1111____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBBAAAA8888____EEEEXXXXTTTT,
  42.                      GGGGLLLL____RRRRGGGGBBBB11110000____AAAA2222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBBAAAA11112222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBBAAAA11116666____EEEEXXXXTTTT.  (Note
  43.                      that the values 1, 2, 3, and 4, which are accepted by
  44.                      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, are not accepted by ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT.)
  45.  
  46.      _x               The x coordinate of the lower-left corner of the pixel
  47.                      rectangle to be transferred to the texture array.
  48.  
  49.      _y               The y coordinate of the lower-left corner of the pixel
  50.                      rectangle to be transferred to the texture array.
  51.  
  52.      _w_i_d_t_h           The width of the texture image.
  53.  
  54.      _b_o_r_d_e_r          The border width of the texture.  Must be 0 or 1.
  55.  
  56. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  57.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT defines a one-dimensional texture image with pixels
  58.      from the current GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR (rather than from main memory, as is the
  59.      case for ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD).
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      The screen-aligned pixel rectangle with lower-left corner at (_x, _y)
  75.      having width _w_i_d_t_h+2*_b_o_r_d_e_r and height 1 is used to define the texture
  76.      array at the mipmap level specified by _l_e_v_e_l.  The internal format of the
  77.      texture array is selected by _i_n_t_e_r_n_a_l_f_o_r_m_a_t.
  78.  
  79.      The pixels in the rectangle are processed exactly as if ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss had
  80.      been called, but the process stops just before final conversion.  At this
  81.      point all pixel component values are clamped to the range [0, 1] and then
  82.      converted to the texture's internal format for storage in the texel
  83.      array.
  84.  
  85.      Pixel ordering is such that lower x screen coordinates correspond to
  86.      lower i texture coordinates, and lower y screen coordinates correspond to
  87.      lower j texture coordinates.
  88.  
  89.      If any of the pixels within the specified rectangle of the current
  90.      GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR are outside the window associated with the current
  91.      rendering context, then the values obtained for those pixels are
  92.      undefined.
  93.  
  94. NNNNOOOOTTTTEEEESSSS
  95.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT is part of the EEEEXXXXTTTT____ccccooooppppyyyy____tttteeeexxxxttttuuuurrrreeee extension.  See
  96.      ggggllllIIIInnnnttttrrrroooo for more information about using extensions.
  97.  
  98. EEEERRRRRRRROOOORRRRSSSS
  99.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated when _t_a_r_g_e_t is not one of the allowable
  100.      values.
  101.  
  102.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than zero or greater than
  103.      log (_m_a_x), where _m_a_x is the returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
  104.         2
  105.  
  106.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if the specified image is too large.
  107.  
  108.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h is less than zero, greater than
  109.                                                                     k
  110.      2+GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE, or when _w_i_d_t_h cannot be represented as 2 +2border
  111.      for some integer k.
  112.  
  113.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _b_o_r_d_e_r is not 0 or 1.
  114.  
  115.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _i_n_t_e_r_n_a_l_f_o_r_m_a_t is not one of the
  116.      allowable values.
  117.  
  118.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT is executed
  119.      between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  120.      ggggllllEEEEnnnndddd.
  121.  
  122. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  123.      ggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                                                         PPPPaaaaggggeeee 2222
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))
  139.  
  140.  
  141.  
  142. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  143.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD and ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT are not supported on
  144.      RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems.
  145.  
  146.      On IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy systems, there is a performance benefit when the width
  147.      of the image to be transferred to texture memory is a multiple of 8.
  148.  
  149.      Texture borders are not supported on IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy systems.
  150.      Applications should use borderless textures and GGGGLLLL____CCCCLLLLAAAAMMMMPPPP____TTTTOOOO____EEEEDDDDGGGGEEEE____SSSSGGGGIIIISSSS
  151.      wrap mode.
  152.  
  153.  
  154. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  155.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT, ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                                                         PPPPaaaaggggeeee 3333
  198.  
  199.  
  200.  
  201.